بسم الله الرحمن الرحيم 


الجمهورية اليمنية- صنعاء 
جامعة المستقبل- كلية علوم الحاسوب 
قسم نظم المعلومات (11) 


درس ھاا اام جدا : 
أدوات التحقق من المدخلات Validation Controls‏ 


في تقنية E1‏ .۸8۲.۸ 


أعداد المهندس/ نبيل محمد لطف مصلي 
Email:-nabil299@gmail.com‏ 
تحت اشراف الدكتور/ عمار الحرازي 


٠ مقدمة‎ 

من اهم العمليات التى تحملها صفحات الويب على عاتقها هى استخلاص البيانات من المستخدم 
ليتم فيما بعد غالبا حفظها فى قاعدة بيانات .. ارتبطت عملية الحصول على البيانات من 
المستخدم بعملية التحقق من البيانات قبل حفظها فى قاعدة 

البيانات حتى نتجنب المشاكل فيما بعد. 


من المفضل أن تتم عملية التحقق على جھاز المستخدم Client-Side‏ عن طريق أكواد جافا 
سکریبت( ٤م‏ ذاc؟[)‏ حیث یتم إخبار المستخدم مباشرة بالخطا قبل أن یتم عمل ال ۲۴٥)8 ack‏ 


البعض يتسأل ماهي عميلية ak‏ 8ء۴0 ؟ 
والجواب:- هي عملية العودة الى السيرفر والرجوع الى المتصفح (المستخدم) أذا لم يحدث 
خطا في الصفحة. 


لكن عملية التحقق لا يجب أن نكتفى بأن تقوم فى ال ء1d؟-٤"‏ ء11٥‏ فقط ..تخيل معى أن 
مستخدم الصفحة التى يجب أن نتحقق من البيانات عليها قبل حفظها لديه خلفية عن الويب 
وقام بحفظ نسخة من الصفحة على جهازة وقام بتحريرها وحذف منها كود الجافا سكريبت 
4ءك[الخاص بعميلة التحقق واستخدمها فيما بعد لإرسال بيانات مخالفة وخاطئة. هنا وجب 
وقوع عملية التحقق فى السيرفر دlئln. Server-Side Validation‏ 


طبعا كتابة أکواد التحقق یدویا أمر متعب سواء کانت أکواد جافا سکریبت أم أکواد 1٤S۶۲۴.۸N؟۸S‏ 
لذلك وفرت لنا ميكروسوفت مجموعم من الأدوات تسمى ءاه ا٤مرمc‏ ٥٥ھ‏ اھ۷ والتی 
تضعها على الصفحة وتربطها بالأداة التى تريد إجراء التحقق عليها. 


يمكنك بواسطة هذه الأدوات التأكد من وجود بيانات أو مقارنتها ببيانات أخرى أو حتى تقييدها 
بقواعد معينة.. كل هذه الأدوات تدعم التحقق على الخادم والتحقق على على السيرفر وذلك 
بشكل افتراضى.. واذا منع المستخدم متصفحة من تنفيذ أكواد الجافا سكريبت سيكون التحقق 
على السيرفر فقط, 


Validation controls : 

محموعة من الأدوات توجد فى التبويب طها٤ ti٥”‏ :اھ۷ فی صندوق الأداوات ×0 ']٥٥18‏ 
وعددها ستة أدوات . تستخدم للتحقق من مدخلات المستخدم كالتحقق من ان لا يترك الحقل 
فارغا .أو ان تكون القيمة عدد صحيح أو حتى اكبر من 

قيمة معينه..وإن فشلت العملية فإنها تمنع الصفحة من عمل P٠18‏ وتظهر رسالة خطاأً 
على أداة. 


هذا ملخص عن الادوات إلى ان يأتى التفصيل لاحقا: 
--الأداة : Required Field Validator‏ تتحقق أن أداة معينه تحتوى على قيمة عند عمل 
ub mit‏ للنموذج .فإذا كنات الأداة فارغة يظهر خطا. 


-الأداة : RangeValidator‏ تتحقق من أن القيمة التى تحملها الأداة تقع مدی معین 
.بین تاریخین ..رقمین .. أو حتی حروف.. 


aid ator :‏ mpareVدC‏ --تتحقق من أن القيمة التى تحملها الادة أكبر من ..أصغر من 
..تساوى ..أكبر من وتساوى .. أصغر من وتساوى... قيمة ثابته تحددها أنت أو حتى قيمة 
تحملها أداة أخرى .. كما يمكنها أن تتأكد من أن الأداة تحمل نوع معين من البيانات أعداد 


Regular Expression Validator :‏ --تتحقق من ان القيمة التى تحملها الأداة تتبع 
تعبیرا معینا تحدده أنت سابقا ..کأن تكون بريد إلكترونى مثلا او حتى رقم تليفون.. 


Custom Validator‏ --تتيح لك إمكانية كتابة أكواد التحقق يدويا على السيرفر بواسطة 
أکواد ۸P. N٤1‏ وحتى على جهاز المستخدم بواسطة أكواد.. مء[ وتلجأ لها فى حالة 
لم تفيدك الأدوات الأخرى. 


Validation Summary :‏ --هذه الأداة ليست للتحقق من شىء معين ولكن يعرض عليها 
ملخص لكل عمليات التحقق الفاشلة. 


يجدر الإشارة إلى إمكانية استخدام أكثر من أداة تحقق على أداة واحدة ..وكما ستعلم لاحقا أنك 
لو استخدمت الاداة 0٤ھ‏ ل211 Range‏ مثلا مع ×0طt×م)‏ فان عملية التحقق ستنجح لو كان 
ال ×50ا٤×6فارغا‏ لأنه ببساطة لا توجد بيانات للتحقق منها.. وهنا تظهر الحاجة الى استخدام 
الأداة Requered Field Validator‏ مع نفس صندوق النص للتأکد من عدم ترکه فارغا. 


لاحظ ان أكثر الأدوات التى تستخدم أدوات التحقق معها هى الأداة.. ج0ط)×م) كما انه يمكنك 
أن تستخدمها مع DropDownList‏ وحتى ۲٥×‏ utمہا‏ ولاحظ فى حالة الأداتين 
"ext DropDownList‏ nputاوامثالھا‏ تتم عملية التحقق على الخاصية eںاوں‏ على 
عكس ال ×0 ط)×ع)والتى تتم عملية التحقق فيه على الخاصية .. ٤×ع)‏ لذلك إن حاولت 
إستخدام ادوات التحقق على {ئز ارس 0م٠5۲‏ مثلا لا تنسى أن تعطى قيمة للخاصية 
مالكل عنصر من عناصرها.. 


لاحظ أيضا أنه لايمكنك استخدام أدوات التحقق مع hy CheckBox yİ RadioButton‏ 
شیء منطقی وبدیهی. 


The Validation Process :قفحتأl عملي‎ 

يمكنك ان تقيم عملية التحقق بطريقتين طريقة اوتوماتيكية حيث تتم عملية التحقق عند الضغط 
على الزر٤نصطں؟‏ ليس الزر انمصطن؟ فقط ولكن اى زر له الخاصية 
CausesValidationتساوى‏ (ع۲۲u‏ حيث أنه عند الضغط على أى زر فإنه تتم أولا 
مراجعة القيمة المسندة للخاصية ر0ناد لاج۷ عءںهC‏ فإذا كانت مء[هf‏ تعمل الصفحة وكأنه 
لا توجد أدوات تحقق عليها واذا كانت مں] يتم التحقق من الأدوات على النموذج اذا حدث اى 
خطأ تظهر الرسائل للمستخدم. 


لاحظ أن العمليات الأوتوماتيكية تعتمد على وقوع حدث النقر لزر له الخاصية 
CausesValidationتساوی‏ eںہ)‏ ولا تعتمد علی حدوث ck‏ ھط٤ءمم‏ لأی سبب آخر 
كحدث Qءع«4 1٥×٤1‏ لصندوق نص مثلا وهنا يمكنك الإعتماد على التحقق بطريقة يدوية 
وكتابة أكواد بناء على النواتج. 


بعد المقدمة التى تعرفنا فيها على أهمية التحقق من مدخلات المستخدم ..وتعرفنا أيضا على 
وظيفه كل أداة من تلك الأدوات بشىء من الإيجاز الشديد ........ دعنا نتعمق. 


تشتق نات الأدوات ValidationControls‏ من الفئة at‏ 1اه ۷ءءه8B‏ والتى تحتوى 
على الأعضاء المشتركة لجميع الأدوات وبدراستها نوفر الكثير من التكرار.. 


من م عضlء‏ llفئة: BaseValidator‏ 
--الخصيصة : 211d 2)٥‏ 0۷ 01۲إ€0nt‏ حدد فيها اداة للتحقق منه البيانات بها. 


الخصيصة:۷هامءآ :تحدد كيف ستظهر رسالة الخطأً للمستخدم ولها ثلاث وضعيات 


ti  @‏ وفى هذه الحالة سیتم حساب الفراغ اللازم لرسالة الخطأً وحجزة بحث تظهر 
الأدوات التى بجانبها لكن بعد تعدى الفراغ اللزم لها . 


٠‏ : eنصهرر(فى‏ هذه الحالة لن يتم عبور الجسر قبل الوصول إليه (مش هنقدر البلاء 
قبل وقوعه) بمعنى انه لن يتم حجز المساحة اللازمة لرسالة الخطأ ..لوكن عند 
وقوعها سيتم إزاحة الأدوات التى بجانبها بالمقدار اللازم لطول الرسالة. ربما تبدو هذه 
الوضعية مناسبة ..لكن احذر منها خاصة اذا كانت صفحتك مملوءة بجداول أو أدوات 
كثيرة. 


N 0n: ٠‏ فى هذه الحالة لن تظهر رسالة خطأ أصلا ولكن سيتم إيقاف الصفحة من 
عمل !! اع وط)وه۴ يعنى ستقوم الأداة بوظائفها من إيقاف الصفحة من عمل 
kءaطstمموغييرها‏ ولكن دون ظهور رسالة للمستخدم. وهذا عند التعامل مع 
الأداة Summary‏ idationاaظهار‏ الأخطاء كلها جملة واحدة. 


--الخصيصة : Enabled‏ لتحدد إذا كانت الادة ستقوم بعملها كأداة تحقق أم أنها لن تعمل 
وتاخذ قیمه من ائنتین ٥ں٣۲‏ أو. eیاھ؟‏ 


--الخصيصة : مع هیوم E۲۲۵۲]‏ تحدد فيها الرسالة التى ستظهر للمستخدم فى الأداة 
ai dation Summary‏ فى حالة فشل عملية التحقق .. وتقبل قيمة نصية. عٍمذ٣)؟S‏ 


--الخصيصة : 1٥×٤‏ وتحدد فيها رسالة الخطأ التى ستظر للمستخدم على أداة التحقق نفسها 


فى حالة فشل عملية التحقق. 
لاحظ الفرق بين الخصيصتùı Text‏ ڃ (Error Message)‏ 


--الطريقة (الوظيفة :19۷1140)) تستخدم بشكل أساسى فى الكواليس للتحقق من كون 
العملية فشلت أم نجحت ..ربما تتساءل إذا كانت تستخدم بشكل أساسى خلف الكوالس ..لماذا لم 


تجعلها میکروسوف .. ()10۸٤cہں۴ ٥۷a‏ ھل أخطأت میکروسوفت؟! 

کید لم تخطئ میكروسوفت ..تابع معى: 

اذا كان لديك صفحة ويب تقوم بضرب القيمة فى صندوق النص فى العدد 10 وإظهار الناتج فى 
أداة .. ااه هنا يجب التحقق من أن المستخدم يدخل قيم رقمية وإلا سيظهر خطأ أثناء 
الوقت التشغيل ٠n٠آ‏ ».8 إذا ادخل قيمة نصية . فإذا أدخل المستخدم قيمة نصية وضغط 
على الزروكان التحقق فى جهة المستخدم ناو لاج۷ ءS1d-ien۲اC‏ متاح فلن يسمح 
المتصفح للمستخدم بعمل عوطءهم لتنفيذ الكود فى حدث النقر للزر. أما اذا كان التحقق فى 
جهة المستخدم غير متاح فان الادة وللأسف ستسمح للزر بعمل kعدط٤ءمم‏ وللأسف سيتم 
تنفيذ كود الضرب الموجود فى الزر مع اظهار رسالة الخطاً (ما فائدتها إذا..(! لذلك وبما أنك لا 
تضمن أن يكون التحقق فى جهة المستخدم متاح ستعتمد على التحقق فى جهة السيرفر وستقع 
فى المشكلة السابقة .. لذلك عليك أولا وقبل كتابة الكود الخاص بعملية الضرب أن تتحقق إذا 
كانت عملية التحقق التى تقوم بها الادة نجحت أم فشلت . لذلك ستختبر القيمة التى تعمود بها 
الوظيفة 114)0ه9۷] فان كانت مں") ننفذ الكود وإن كانت مء1ه] لا نريد منه أن ينفذ لنا شىء 
لذلك سيكون كود حدث النقر للزر يشبه التالى: 


If Validator.IsValid Then 
Label1.Text = TextBox1.Text * 10 
EndIf 
1(5 حیث ۲ہtھ 11اه ۷ تشير إلى اسم الأداة البرمجى.‎ 


الحالات المشابهة :لن تختبر القيمة التى تعود بها الوظيفة (IsValid‏ لكل أداة على حدی 
لذلك ستستخدم الوظيفة Q1sValid‏ للصفحة والتى تعود بالقيمة مں) اذا لم يكن هناك أ 
عملية تحقق على الصفحة فاشلة وتعود بالقيمة مء[ه] اذا كانت هنا على الأقل أداة تحقق فشلت 
عملية التحقق بها. 


هناك بعض الخصائص متل ۴0۲٥٣010۲‏ و 010۲ Bac)€‏ و font‏ وغیرھا من 
الخصائص التی لیس لها علاقة مباشرة بأدوات التحقق ولكن لها علاقة بالأدوات بشكل عام . 
لذلك سنناقشها فى النهاية مع بعض الأشياء الأخرى تحت عنوان ((اللمسة الجمالية.)) 

RequiredField Validator |ڈدا5:‎ lg 


هى ابسط الأدوات تتحقق من أن الأداة التى ترتبط بها ليست فارغة أو تحتوى على مسافات 
فقط فى هذه الحالة تفشل العملية اما اذا كانت تحتوى بيانات فإن العملية تعبر بكل سلام. 


وهناك خاصية لها تسمى عمںاه1۷ه1)ام!] فإذا حددت لهذه الخاصية قيمة ..فإن عملية التحقق 
تفشل اذا ادخل المستخدم نفس البيانات اللتى حددتها انت فى الخاصية ٥ں‏ اه 1۷هام[ وتنجح 
العملية اذا ادخل اى قيمة أخرى أو حتى ترك الحق فارغ. 

وکمثال لهذه للاداة:- 


<asp:TextBox runat="'server'' ID='"'Name'"" /> 
<asp: RequiredField Validator runat=''server'" 
ControlToValidate=''Name'"" 
Display='"'dynamic''>Name is required 

<lasp: RequiredField Validator> 


حيث ستظهر هذه الجملة '"Q٥٣إu‏ ع۲ا ك¡ مNam''‏ فى الأداة اذا عمل المستخدم Submit‏ 
للفورم ولم يدخل قيمة فى صندوق النص.. ء14۳ 


وترى هذا المثال واضحا عند التسجيل فى المنتديات مثلا.. حيث حقل إسم المستخدم مثلا لا 
يجب أن يترك فارغا . 


RangeValidator |لأدا5:‎ lyنlأ‎ 


تتحقق من أن القيمة التى تحملها الادة المرتبطة بها تقع بين مدى معين. 

ومن أهم خواصها: 

--الخصيصة مم رآ والتى تحدد نوع البيانات التى ستتحقق الأداة من وقوعها بين مدى معين 
ويمكن أن تكوString.jù Currency, Date, Double, Integer, and‏ 


--الخصيصة عںآه ۷ص ”u‏ اما تحدد أقل قيمة صالحة للبيانات داخل الأداة المرتبطة بها. 
۔-۔الخصیصۂ ع ں[ھ ۷ Ma×x1 ٣u‏ تحدد أقصى قيمة صالحة للبيانات داخل الأداة المرتبطة 
بھا. 


وهذا مثال للأداة: 


<asp:RangeValidator runat=""'server'' Display="'dynamic'"" 

Control ToValidate='""DayOff"' Type=""Date'"" 

MinimumV alue='""08/05/2005 Maximum Value=""08/20/2005>Day Off is not within 
the valid range 

<lasp:RangeV alidator> 


حيث تتحقق الأداة من أن التاريخ المدخل الى الحقل ۴؟0ره( يقع فى المدى من ٠‏ اغسطس 
٠٠٠١‏ إلى 20 اغسطس ۲٠٠۸‏ وإلا يظهر رسالة تدل على ان التاريخ غير مقبول ولا يقع 
ضمن المدى. 


CompareValidator لأدا5:‎ ll 


تتحقق هذه الأداة من كون البيانات التى تحملها الأداة المرتبطة بها أكبر من ..أصغر من 
..تساوى ..أكبر من وتساوى .. أصغر من وتساوى... قيمة ثابته تحددها أنت أو حتى قيمة 
تحملها أداة أخرى .. كما تتأكد من أن الأداة تحمل نوع معين من البيانات أعداد صحيحة مثلا. 


وتستخدم عند التسجيل فى المنتديات للتحقق من ان حقل كلمة المرور وحقل التحقق من كلمة 
المرور يحملان نفس القيمة .... وايضا للتحقق من أن تاريخ الميلاد أقل من تاريخ التسجيل!! 


من أهم خصائصها: 

۔۔کما فی أختھا Range Validator‏ eطآ‏ لها الخصيصة ٥م‏ رآ والتی تحدد نوع البيانات 
التى ستتحقق الأداة من ادخالها فى الحقل.. كما تحدد نوع البيانات التى ستتم مقارنتها 

Currency, Date, Double, Integer, and String . 


يا حبيبى.. قد تتساءل لم نحدد نوع البايانات فإذا أردنا أن نتحقق مثلا من أن القيمة فى صندوق 
النص ١‏ أكبر من القيمة فى صندوق النص ۲ ولم نحدد نوع البيانات فى الخصيصة ٥رر‏ 
0 1 + النتيجة. 


تنويه : بهذا الإعتقاد قد أخطأت.. 
جرب معى تطبيق فيه صندوقين نص وأداة هاه 1اه ۷ءاومصهC‏ لها الخصائص التالية 


8 Fort 
ForeColar Red 


| textbook? is less Ethan textbo#m 1 
ا‎ Behavior 


oantrolToZaompare TeHEBo# 1 
Cerro ermpor TeHtBomZ 
ul tureInyariantyz False 
EnableZlisntScripE True 


Enablad TFUE 
EnablaThernirıg TrUE 


per atoar GreaterThan 


SetFacusOnError False 
SkinlD 
ToanlTip 


lTypE rng [ 
walidationtaroup 
wale ToZarmparEe 
Wisibla TrUE 


تلاحظ فى الصورة أننا تركنا الخاصية مرآ لها القيمة ga String‏ أننا سنقارن ارقام 

6 ]وهذا سینتج عنه خطاً فظيع .. فقط تابع. 

تذكر أن الهدف من تطبيقنا هو التحقق من أن القيمة فى صندوق النص ۲ أكبر من القيمة فى 
صندوق النص .١‏ 

الآن نفذ مشروعك واكتب فى صندوق النص الأول القيمة "٠"‏ وصندوق النص الثانى القيمة 
٠"‏ الآن سيظهر خطأً على الأداة لأن القيمة فى الصندوق الثانى أقل من القيمة فى الصندوق 


الأول وهذا الطبيعى 


الآن اكتب فى صندوق النص الأول القيمة "٠٠"‏ وصندوق النص الثانى القيمة ٩"‏ " 
ماذا تتوقع ؟ ! 
تتوفع ؟ ! 


تتوقع ظهور رسالة خطأ على الأداة .. تفكيرك منطقى وسليم ولكن سيحدث عكس هذا ..حيث 
سيعبر التحقق بسلام ولن تظهر أى مشكله.. 


السبب هو أنك حددت القيمة string‏ للخاصية type‏ للأداة حيث ستعامل أداة التحقق القيم فى 
صناديق النصوص على انها حروف فستقرأً أداة التحقق القيم من اليسار وتقارن قيمة بقية 
وستجد أن التسعة أكبر من الواحد فتعتبر أن القيمة فى الصندوق الثانى أكبر منها فى الصندوق 
الأول. 


لذا احذر وتعامل مع الخاصية ءم را وانت تعلم قيمتها ومن يعلم اذا كنت فى المثال السابق 
تتعامل مع عملات .. 


--الخصيصة ValueToCompare‏ وتستخدمها اذا كنت ستحدد قيمية ثابته تقرنها باقيمة 
التى تحملها الأداة المرتبطة بها. 


--الخصيصة ١إوم ٥٥٠٤۲٠1١١٣١‏ والتى ستحدد الأداة التى ستتم مقارنة قيمتها بالقيمة 
التى تحملها الادة المرتبطة بها... 
وتستخدم واحدة منهما فقط 


--الخصيصة إه٤دإءم0‏ والتى تحدد نوع المقارنة بين القيمتين وممكن تكون 
DataTypeCheck Equal, NotEqual, GreaterThan, GreaterThanEqual,‏ 
LessThan, LessThanEqual, and‏ 


القيمة DataTypeCheck‏ لهذه الخصيصة تجبر الأداة على التحقق اذا كان نوع البيانات 
المدخل فى الأداة المرتبطة بها هو نفسة نوع البيانات المحدد فى الخصيصة ءمرآ وإلا تفشل 
¢ لية اأ فة 


وکمتال على الأداة: 
<asp:CompareV alidator runat='"'server'' Display='"'dynamic""‏ 
ControlToValidate=''Age'' ValueToCompare=""18'""‏ 
ErrorMessage='"'"You must be at least 18 years old'""‏ 
Type=""'Integer'' Operator='"'GreaterThanEqual''>*‏ 
<lasp:CompareValidator>‏ 


يتحقق من أن القيمة التى تحملها الأداة المرتبطه بها أكبر من أو تساوى ۸٠وإلا‏ يظهر فشل فى 
العملية. 


مثال آخر: 
<asp:CompareV alidator runat=""'server'"‏ 
ControlT'oValidate='"'Password2'' ControlToCompare=""'Password'""‏ 
ErrorMessage=''The passwords don't match'""‏ 

Type="'String'"' Display='""'dynamic''> 
<lasp:CompareValidator> 


يتحقق من أن القيمة التى يحملها صندوق كلمة المرور الأول يساوى صندوق كلمة المرور 
الثانى. 
lly‏ !أد|5: RegularExpression Validator Control‏ 


هذه الأداة تعد أقوى الأدةات حيث تسمح لك بالتحقق من ان البيانات التى تحملها أداة معينه 
تتبع صيغة معينه بريد إلكترونى أو عنوان موقع 081ل أو رقم تليفون وغيره. 


بالرغم من انه یمکنها أن تتأکد أن المدخل هو ۸ال أی انها تبدا ب ۲۲ 1۲اوینهى ب إه٥٤.‏ 
مثلا إلا أنه لم يدعم البحث عن هذا العنوان على الانترنت والتحقق إذا كان موجود أم لا. 
من أهم خصائصها الخصيصة,هذءءءإم «٤×‏ هن)ه لاج۷ ولها العديد من القيم مثل 


]nternet URL ر‌أ:Internet E-mail Address‏ وغیرھا. 


كما يمكنك أن تكتب التعبير يدويا عن طريق .. تابع الصورة... 
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فى صندوق النص الموضع بالصورة السابقة اكتب التعبير المطلوب.. ماذا ستكتب؟. 
ستكتب رموز تعبير بها عن التعبير المطلوب تسمى هذه الرموز كإم)هإ2 ط٣4٤‏ تراها 
بشكل مفصل فى هذه الروابط ..حيث أنها علم آخر ليس هذا مجالها. 


Custom Validator Control] |لأد|5:‎ walخ‎ 


لو عملية التحقق المطلوبة تحتاج مرونة أكبر وإمكانيات اكبر من التى تتيحها لك الأداوت 
السابقة(كأن تريد أن تتحقق أن القيمة المخلة هى سنة كبيسة مثلا.. 2۲٠ء۷‏ مهع] فى هذه 
الحالة ستdلجÎ‏ أڈد|5. CustomValidator‏ 


بواسطة هذه الأداة يمكنك أن تكتب كود التحقق على خادم والسيرفر يدويا ..إذا فشلت عملية 
التحقق ستعود الطريقة 1140ه9۷] والخاصة بالفورم بالقيمة مءإه۴ وتظهر رسالة خطأً على 
الاداة مثل أى أداة أخرى. 


لإجراء عملية التحقق على جهاز المستخدم عليك كتابة الأكواد بواسطة ام ذ5ل وللأسف لم 
أتعلم الجافا سكريبت حتى الآن 


ولإجراء عملية التحقق على السيرفر نأخذ المثال التالى .. حيث نريد أن نتحقق من أن القيمة 
التى يحملها صندوق النص المسمى إوءرمهء][)×) يحمل رقم سنة كبيسة. 


سنكتب أكوادنا فى الحدث Custom Validator1_Server Validate‏ لأداة التحقق حيث 
نختبر القيمة التى تحملها الأداة المرتبطه بها عن طريق فحص القيمة فى الخاصية 
ueاs.vaعاهفإذا‏ كانت تقبل القسمة على > بدون باقى ستجعل الخاصية iQاه۷كء1.١ءعا4‏ 
تساوى مں٣)‏ وتمر عملية التحقق بسلام. 


واذا لم تكن تقبل القسمة على 4 تكون السنة غير كبيسة ونسند القيمة ماه للخاصة 
.يع اهوسيظهر الخطأ على أداة التحقق وكذلك ستعود الطريقة 114)0م۷ء¡.معمم 
بالقيمه. seاھf‏ 

الكود للحدث مةلناه۷٣ع۷م؟‏ لأداة التحقق سيكون مثل التالى: 


Dim i As Integer = CInt(args. Value) 
If (i Mod 4) = 0 Then 


args.IsValid = True 
Else 
args.IsValid = False 


End If 


الآن انتهینا من أدوات التحقق .. تبقى لنا الأدة روصرص u؟م‏ هة لاج۷ والتى لا تعد أداة 
تحقق بل هى أداة لنظهر عليها كل عمليات التحقق الفاشلة فى مكان واحد وبشكل محدد. 


ValidationSummary Control |أد|5:‎ lualخ‎ 


وكما أشرت فى المشاركة السابقة إنها ليست أداة تحقق مثل أخواتها أى أنك لن تربطها بأداة 
معينة للتحقق من شىء ما ! وبدلا من ذلك فإنها تظهر ملخص لكل الأخطاء التى حدثت على 
الصفحة . حيث يظهر عليها القيم الموجودة فی الخاصیة eعھیوم۷1 ۴٣٣٥۲‏ لجمیيع الأدوات 
التى فشلت بها عملية التحقق .ويمكنك أن تخصصها ل upهإ‏ ۸6 ٥1٤11و‏ ۷محدد. 


هذه الأداة يمكن أن تظهر على شكل رسالة (messageBox)‏ وذلك بالاعتماد على کود 
(1p0اe‌ء[)الکود‏ لن تكتبه انت حيث انها ستظهر بدون عمل )ه8١٠۴‏ لو الخاصيهة 
true .4nيقلاl l4j ShowMessageBox‏ 


كما أنھا تظھر على الصفحة نفسھا إذا كانت الخاصیۂ روہ ص Su؟w٥طS‏ لھا القيمة. عںuا)‏ 
ويمكنك التعامل مع الإسلوبين أو التعامل مع إسلوب واحد فقط. 

لو كان الاسلوب الثانى إحدى خياراتك : فيمكنك أن تختار الشكل الذى ستعرض به الأداة عن 

List yİ SingleParagraph jوكت‎ jİ والتڪ يكن‎ 1ءماھy‎ M0 : طريق :الخاصية‎ 

BulletList.g 

يمكنك أيضا ان تحدد عنوان للأدة عن طريق الخاصية . Header Text‏ 


»*# | ا111 
40 
الأشتال المختلغة للخاصية علعما٣پهامءاح.‏ 


rors Field #1 is important Field Must be in Î to 10 
ms _- ذد قيصة الخاصية‎ 


ölzÎl HeaderText 
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الرسائل التی تظھر شنا شى قيدح ائغZخlاصھuة Error lessaqe‏ 
للادوات التى قشل بها التحقق. 


» Field #1 is important 


» Field Must be in İ to 10 


Windows Internet Ekplorer 


ErFOrS 
Field #1 is inpartant Field Must be in 1 to 10 


نرى فى الصورة ظهور رسالة الخطأً على كلا من اداة التحقق نفسها وكذلك الأداة 


messagebox Jآڎذ‎ lضyİgValidationSummary‎ 


واذا اردنا ان تظهر الرسائل على الأداة ValidationSummary‏ فقط.. نجعل الخاصية 
Display‏ دوات التحقق الموجودة على الصفحهة تساو ى. None‏ 
الآن انتهينا من الأدوات وتبقى بعض المواضيع المتفرقة 


التعامل مع دوات التحقق برمجيا (عن طريق الكود) 


مثل جميع الأدوات الأخرى التى تعمل على السيرفر يمكننا التعامل مع ادوات التحقق عن طريق 
الكود وتعديل خصائصها .. يمكنك أن تصل إلى جميع أدوات التحقق على الصفحة عن طريق 
ال o11 ecti0n‏ السمى كإمtھ‏ 14اه ۷ داخل الفئة معهم فمثلا هذا الكود يوقف عمل جميع 
أدوات التحفق الموجودة على الصفحة: 


For Each ctrl As BaseValidator In Page.Validators 
ctrl.Enabled = False 


Next 


بفرض : أنه لديك صفحة فيها صندوقى نص وأداتى تحقق وتريد أن تجعل خلفية صندوق 
النص الذى فشلت فيه عملية التحقق هى اللون الأحمر منلا .كل شىء بالكود.. 


أولا لابد أن يكون هناك زر أمر على الصفحة ولكن دعنا نجع الخاصية CausesValidation‏ 
له تساوی مءآ[ھع حتى لا تتم عملية التحقق آليا لآنه إذا تم التحقق آلیا لن یتم ال ckھطt٤sھم‏ 
وبالتالى لن ينفذ الكود فى حدث النقر وهذا غير مطلوب. 


بعد ذلك اكتب فى حث النفر للزر كود كالتالى: ۰ 
Me.Validate()‏ 
For Each ctrl As BaseValidator In Me.Validators‏ 


If ctrl.IsValid = False Then 


Dim X As TextBox = 
CType(Page.FindControl(ctrl.ControlToValidate), TextBox) 
| X.BackColor = Drawing.Color.Red 
| End If 


Next 


فى السطر الأول : جعلنا الصفحة تتحقق من الأدوات الموجودة عليها. 


فى السطر الثانى : نبحث عن جميع أدوات التحقق الموجودة على الصفحة ويشير المتغير [)ء 
الى كل أدة يجدها. 
فى السطر الثالث : نختبر القيمة التى تعود بها الوظيفة 

۷210 ]االخاصة بكل أداة على الصفحة فإذا كانت عملية التحقق فاشلة أى أن الوظيفة تعود 
بالقيمة<< مء[ھf‏ 


فى السطر الرابع: عرفت متغير بالإسم × من النوع ×80×ع1 وبعد العلامة "=" استخدم 
کود مرکب شویه .. تابع معی: 


الوظيفة [إه٣٤ره ۴,4٣‏ الخاصة بالصفحة ءعٍه۴ تأخذ بارمتر عبارة عن الإسم البرمجى 10 
لأى أداة موجودة بالصفحة وتعود بكائن من نوع )٥١٤٣01‏ وهو عبارة عن الأداة الموجودة 
على الصفحة والتى تحمل نفس الإسم الذى مررته إليها .وبما أنها تعود بكائن من نوع 
n1‏ ع أى أنه ليس محدد .. استعملنا المعامل مم رآ لتحويل الكائن من النوع 

0ntr1‏ !لى 0x‏ طext‏ ا وھکذا اسندناہ إلى المتغیر × والذی لهھ النوع × 8)×م) ایضا.الآن 
الكائن × يشير إلى أداة صندوق النص المرتبطة بأداة التحقق التى يشير إليها المتغير. ٣)‏ 
فى السطر الخامس : غيرنا لون الخلفية للأدة × والتى بدورها تغير لون الخلفية لصندوق 
النص إلى اللون الأحمر. 


Validation Groups :‏ 
فى الصفحات المعقدة والكبيرة.. ربما تجد نفسك تريد أن تقوم بكل عملية تحقق لمجموعة من 
الأداوت على حدی .. ریما تکون الأدوات مقسمه بواسطة و[مر و٥‏ مثلا. 


كمثال على ذلك .. تريد إنشاء صفحة تحتوى على أداوت لتسجيل الدخول للموقع «آعه.[] وفى 
نفس الصفحة أدوات للتسجيل فى الموقع.. 


وهنا تجد زر ا٤نہ‏ طاںء لکل جزء على حدی .. وطبعا بناء على کل زر على حدی ترید إجراء 
عملية تحقق .. فكيف تتصرف؟؟! 


الحل يكمن فى تفنية وفرتها لك ميكروسوفت ..sمupه0ا6‏ ١٥1اة‏ اه۷ حيث تضع كل 
مجموعة من الأدوات فى pسuهإ ٣6‏ هاده اه۷ هذا التقسيم ليس فيزيائى أى أنك إذا وضعت 
كل مجموعة من صناديق النصوص وزر ال امم سء فى أداة اموم مثلا.. لن يجدى هذا نفعا 
.. ولكن التقسيم يكون عن طريق الخاصية pسuهإ6,ه:اد‏ 10اه لكلا من الزر ومجموعة 
الأدوات التى يرتبط عمله بها حيث تحصل كل مجموعة على اسم واحد خاص بها .. فأدوات 
تسجيل الدخول للموقع مثلا تكون الخاصية upهإ ٣6‏ !)اه۷ لها تساوى مع[ ومجموة 
الأداوت الخاصة بالتسجیل فی الموقع لھا الخاصیة up‏ 0ا 6٥1ھ‏ 11ھ ۷ تساوی ع۲ مثلا 


الآن لو وضعت زر نص طنء له الخاصية مuهإ6,٥ا)د‏ لاج۷ فارغة هل سيترتب على 
ضغطة إجراء عملية تحقق لجميع الأدوات على الصفحة بغض النظر عن 
ال rup‏ lidationGا۷aالتی‏ تنتمى إليه الادوات. 


للأسف ذهب بك هذ التفكير بعيدا .. فهذا الزر لن يترتب على ضغطة إلا إجراء التحقق للأدوات 
التى لها الخاصية upهإا6,٥ذاد‏ :اه۷ فارغة أيضا وليس كل الأداوت على النموذج. 

وبناء على السطر السابق ريما تقول .. لو قسمت الأدوات على الصفحة إلى رمن)وidإم۷‏ 
685 ووضعت علی الصفحة زر دہ طںء لا یتبع up‏ 0ا 6٣٥1ھ‏ 1dا۷a‏ محدد سیتم 
postback Jaze‏ للصفحة بنجاح وکأنه لا توجد أدوات تحقق على الصفحة أصلا ..وهذا 
بالتأكيد غير مطلوب. 

كلامك صحيح تماما.. ولحل مشكلة مشابهة يكون الحل بإحدى الطريقتين التاليتين:. 


إما أن تضاعف أدوات التحقق على الصفحة مثلا بدل من أداة تحقق RangeValidator‏ 
واحدة ستضطر تضع اثنتين واحدة تتبع مها 6,٠1)د‏ لاج۷ محدد والأخرى تكون الخاصية 
Validation Group‏ لها فارغة وذلك لمواجهة إحتمالين وهما إما أن يضغط المستخم زر 
itاصطuءالخاص‏ بجموعة محددة أو يضغط الزر الذى لا يخص مجموعة محددة .. وهذا 
للأسف حل معقد ويفقد البرمجة بعض جمالها وبعيد عن الحياة العملية. 


الحل الثانى وهو الأفضل .. أن تقسم الأدوات إلى مجموعات بدون مشاكل وكل مجموعة من 
الأدوات لها الخاصية ValidationGroup‏ متشابهة .هذا نواجه احتمال ضغط المستخدم 
لزر ٤ز‏ طنء الخاص بمجموعه محددة. 


ولمواجهة احتمال ضغط المستخدم لزر انإ طںء الذى لا يتبع مجموعة محددة نكتب فيه الكود 
يدويا ..وكما ناقشنا ذلك فى الجزء(( التعامل مع أدوات التحقق برمجيا)) 


حيث يمكنك أن تستدعی الوظیفة )٥٤ھ‏ 11۵ھ ٥.۷‏ عھP‏ مع تحدید بارمتر نصی لھا یشیر إلى 
إسم ال grup‏ idationاvaوبد‏ 
ذلك ترى القيمة التى تعود بها الطريقة 114ه۷ء1.معهم بعد كل. 


page.validate(''groupname'"") 


ملحوظة:- الوظيفة Page. Validate)‏ معمول لھا إعادة تحمیل gہ4d٥er۲1ہ0‏ عند 
تعريفها بحيث يمكنك أن تحدد التعامل برمجيا مع مuها۲عها)‏ ةلاه محدد بتمرير اسمه إلها 
کالتالی ملا 


Page.Validate(''group1'"") 


لاحظ أيضا مع الإهتمام : لو كانت الصفحة مقسمةإلى مجموعات وإختبرت الوظيفة إناو۷ء¡ () 
لها ستعود بالقيمة م دائما إلا اذا كانت عليها مجموعة من الأدوات التى لا تتبع مجموعة 
محددة .. واذا اختبرت كل مجموعة فیھا على حدیى مٺأpage.validate ("group")‏ 
سيكون هناك إحتما أن تعود الوظيفة iQاد۷ءا.ءعوم‏ ب عمu١)‏ أو مء[وf‏ حسب عملية التحقق 


انتهينا من جميع المواضيع المختصة بأدوات التحقق .(s[ه C0٤‏ 0خ idaاVa)‏ الآن 
وسوف أضيف ان شاء الامثلة العملية في وقت لاحق أن شاء الله 
وأعلم أن الموضوع به تقصير كبير .. لو اكتشفت خطأ راسلنى على الايميل الموجود في بداية 


الكتاب لتصحيحه. 
وفي الاخير و 
أسال الله العظيم رب العرش الكريم أن ينصر أخواننا في غزة الحبيبة 
. أمين اللهم أمين 


ونسأل الله التوفيق وأرجوا من القارى الكريم نشر هذين الموقعين:- 
١-موقع‏ غزة تحترق 

۲-صید الفوائد 

والدال على الخيركا فاعله a‏ 


